Swift Lab 


We base our Swift Lab on Essex/Stable version of OpenStack. 
The installation was done using SAIO-Swift All In One procedure. To get an overview of SAIO, 


go here: http://docs.openstack.org/developer/swift/development_saio.html 
The virtual machine emulates running a 4 node Swift Cluster. 


Getting Started 


Start VirtualBox 

Start>System>VirtualBox 

Choose SAIO> start 

SAIO OS User/Password: swift/swift 

startmain #this script will start the proxy, object, container, and account servers 


Swift CLI 

To log in to Swift CLI, supply credentials by setting environment variables: 
export ST_USER=test:tester #Username:Password 
export ST_KEY=testing #Key name 

export ST_AUTH=http://127.0.0.1:8080/v1.0 #URL of the authentication 
source swiftrc.sh #Alternatively, use swiftrc.sh to load the variables 


Get the status of swift installation 
swift --version #displays the swift version number 
swift stat #displays the status of the account 


Create a Container 


swift list #lists all available containers 

swift post bootcamp #creates a container named bootcamp 

swift list 

swift stat bootcamp #displays information about container: bootcamp 


Upload Objects 

cd /home/swift/tmp 

swift upload bootcamp test.mov #upload test.img to bootcamp container 
swift list bootcamp #lists all files in bootcamp container 

swift stat bootcamp test.mov #displays information about object:test.mov 


Try uploading test.img, test.doc, test.xls to bootcamp container on your own 


Download Objects 

cd /home/swift/tmp 

rm test.mov #remove test.mov from local disk 

11 #verify test.mov has been removed 
swift download bootcamp test.mov #downloads test.mov to /home/swift/tmp 


Add metadata to Objects and Containers 
swift post -m Color:Blue bootcamp #adds metadata to container:bootcamp 
swift stat bootcamp #look for metadata that was added above 
swift post -m Genre:Comedy bootcamp test.mov 

#adds metadata to object:test.mov 
swift stat bootcamp test.mov #look for metadata that was added above 


Delete files in container 
swift delete bootcamp test.img 
swift list bootcamp #shows remaining file excluding test.img 


Delete Container(including all files) 
swift delete bootcamp #bootcamp container along with all files are deleted 


Authentication Tokens 

Obtain token: 

curl -v -H 'X-Storage-User:test:tester' -H 'X-Storage-Pass:testing' http:// 
127.0.0.1:8080/auth/v1.0 

Use Token: 

curl -v -H 'X-Auth-Token: <token-from-x-auth-token-above>' <url-from-x-storage-url- 
above> 


Swift basic commands: 
http://docs.openstack.org/trunk/openstack-object-storage/admin/content/swift-cli-basics.html 


